home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / INTERNET / BROWSERS / GLUESTIK.ZOO / readme < prev    next >
Encoding:
Text File  |  1996-08-26  |  3.8 KB  |  99 lines
  1.     ==== WARNING = WARNING = WARNING = WARNING = WARNING = WARNING ====
  2.  
  3.      This is beta software.  It is not currently known to have bugs or
  4.      incompatibilities with existing STiK apps; nevertheless, use this
  5.      software at your own risk.
  6.  
  7.     ==== WARNING = WARNING = WARNING = WARNING = WARNING = WARNING ====
  8.  
  9.                              GlueSTiK v0.02b1
  10.                       Scott Bigham   dsb@cs.duke.edu
  11.  
  12. INSTALLATION AND USE
  13.  
  14. Copy GSDRIVER.EXE and GSDAEMON.PRG to pretty much wherever you want
  15. them.  Add the following line to your MINT.CNF file:
  16.  
  17.     exec c:\path\to\gsdaemon.prg
  18.     exec c:\path\to\gsdriver.exe
  19.  
  20. If you don't already have a STiK config file, you will need to create
  21. one.  Create a subdirectory STIK_CFG in the root directory of your boot
  22. drive, and create in it a file called DEFAULT.CFG (if you want to put it
  23. somewhere else or name it something else, consult the STiK docs for the
  24. use of the STIK_DIR.DAT file).  This file should contain at least the
  25. line:
  26.  
  27.     ALLOCMEM = 50000
  28.  
  29. Other STiK apps may require additional entries.
  30.  
  31. Reboot your computer.  You should see two new programs installing
  32. themselves:  GSDaemon and GSDriver.  Now connect to your ISP in the
  33. usual way and run your STiK apps.
  34.  
  35. COMPATIBILITY
  36.  
  37. I have done preliminary testing with the following STiK apps and found
  38. no compatibility problems:
  39.  
  40.    - CAB v1.31
  41.    - FINGER v1.00
  42.    - FORECAST v0.4
  43.    - TELNET v1.00
  44.  
  45. TECHNICAL STUFF
  46.  
  47. Unless you're interested in how GlueSTiK works, you can stop reading
  48. now; just note the e-mail address at the bottom to report problems.
  49.  
  50. Version 0.02 of GlueSTiK comes in two pieces.  GSDaemon runs as a
  51. background process and is responsible for actually interacting with the
  52. network.  GSDriver is a TSR that sets up the STiK function table and
  53. hands off STiK network commands to the network daemon.  This is
  54. primarily to eliminate the library-level collisions that caused some
  55. STiK apps to crash with earlier versions.
  56.  
  57. Note that the daemon and the STiK app communicate with each other by
  58. writing into each other's memory space.  If you run MiNT without memory
  59. protection (by renaming MINT.PRG to MINTNP.PRG), this is not a problem;
  60. otherwise, you may need to use a program-flag setting utility to set the
  61. memory flags of your STiK apps to global.
  62.  
  63. There are some places where I was unable to reproduce STiK's exact
  64. functionality; you can find these places by searching transprt.c for the
  65. word `Incompatibility'.  Otherwise, comments are fairly sparse, mostly
  66. notes to myself.
  67.  
  68. There are two main #define's for selecting compile-time functionality:
  69.  
  70.     DEBUG
  71.       Activates the debugging log.  Not likely to be of interest unless
  72.       you're debugging GlueSTiK itself.
  73.     BLOCK_OPEN
  74.       Selects between blocking and non-blocking opens.  In the Berkeley
  75.       sockets package, connect() is blocking by default; that is,
  76.       control does not return to the program until the connection is
  77.       completely established and the socket is ready to receive data.
  78.       In STiK, TCP_open() is non-blocking; that is, control returns to
  79.       the program immediately, while the connection is still in
  80.       progress, and the program must do its own waiting until the
  81.       connection is established.  Since handling non-blocking
  82.       connections is conceptually hairy, this compile-time option allows
  83.       GlueSTiK to be switched between blocking and non-blocking.  This
  84.       distribution is compiled with blocking opens; to date, I have not
  85.       noticed any problems caused by this.
  86.  
  87. testit.c is a quick-n-dirty program I threw together to do basic testing
  88. of GlueSTiK.  It should not be used as a guideline for STiK application
  89. programming. ;)  You can build it with `make test'.
  90.  
  91. BUGS
  92.  
  93. None that I know of; presumably a few that I don't.  Report any problems
  94. you may have to me at dsb@cs.duke.edu.
  95.  
  96. That's pretty much it.  Remember, it's just a beta.
  97.  
  98.                         -sbigham
  99.